package cn.iocoder.yudao.module.api.promotion.gift;

import cn.iocoder.yudao.module.api.promotion.gift.enums.GiftRecordStatus;
import jakarta.annotation.Nullable;

import java.util.Set;

/**
 * <pre>
 * OOoO0OOoO0OOOooo0oOOOO0OOOOO0oooOO0ooOOO0Ooooo0OOOOo0ooooO0OOooo0Ooooo0OOOOO
 *  这里是文件说明
 * OOoO0OOoO0OOOooo0oOOOO0OOOOO0oooOO0ooOOO0Ooooo0OOOOo0ooooO0OOooo0Ooooo0OOOOO
 * </pre>
 *
 * @author 山野羡民（1032694760@qq.com）
 * @since 2025/05/16
 */
public interface GiftRecordApi {

    /**
     * 创建赠品记录
     *
     * @param userId 用户编号
     * @param tradeNo 交易单号
     * @param giftActivityIds 赠品活动编号
     */
    boolean pending(Long userId, String tradeNo, Set<Long> giftActivityIds);

    /**
     * 获得用户的赠品数量
     *
     * @param userId 用户编号
     * @param status 赠品状态，{@link  GiftRecordStatus}
     * @return 赠品数量
     */
    int getCountByUserId(Long userId, @Nullable Integer status);

}
